home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 3.iso / dist / fw_openssl.idb / usr / freeware / catman / p_man / cat3 / SSL_CIPHER_get_name.Z / SSL_CIPHER_get_name
Text File  |  2001-01-10  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      SSSSSSSSLLLL____CCCCIIIIPPPPHHHHEEEERRRR____ggggeeeetttt____nnnnaaaammmmeeee((((3333)))) 11118888////SSSSeeeepppp////2222000000000000    ((((0000....9999....6666))))    SSSSSSSSLLLL____CCCCIIIIPPPPHHHHEEEERRRR____ggggeeeetttt____nnnnaaaammmmeeee((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       SSL_CIPHER_get_name, SSL_CIPHER_get_bits,
  10.       SSL_CIPHER_get_version, SSL_CIPHER_description - get
  11.       SSL_CIPHER properties
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.        #include <openssl/ssl.h>
  15.  
  16.        const char *SSL_CIPHER_get_name(SSL_CIPHER *cipher);
  17.        int SSL_CIPHER_get_bits(SSL_CIPHER *cipher, int *alg_bits);
  18.        char    *SSL_CIPHER_get_version(SSL_CIPHER *cipher);
  19.        char    *SSL_CIPHER_description(SSL_CIPHER *cipher, char *buf, int size);
  20.  
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.       _S_S_L__C_I_P_H_E_R__g_e_t__n_a_m_e()    returns    a pointer to the name of
  24.       cccciiiipppphhhheeeerrrr. If the argument is the NULL pointer, a pointer to
  25.       the constant value "NONE" is returned.
  26.  
  27.       _S_S_L__C_I_P_H_E_R__g_e_t__b_i_t_s()    returns    the number of secret bits used
  28.       for cccciiiipppphhhheeeerrrr. If aaaallllgggg____bbbbiiiittttssss is not NULL, it contains the number
  29.       of bits processed by the chosen algorithm. If    cccciiiipppphhhheeeerrrr is
  30.       NULL,    0 is returned.
  31.  
  32.       _S_S_L__C_I_P_H_E_R__g_e_t__v_e_r_s_i_o_n() returns the protocol    version    for
  33.       cccciiiipppphhhheeeerrrr, currently "SSLv2", "SSLv3", or "TLSv1". If cccciiiipppphhhheeeerrrr is
  34.       NULL,    "(NONE)" is returned.
  35.  
  36.       _S_S_L__C_I_P_H_E_R__d_e_s_c_r_i_p_t_i_o_n() returns a textual description of
  37.       the cipher used into the buffer bbbbuuuuffff of length    lllleeeennnn provided.
  38.       lllleeeennnn must be at least 128 bytes, otherwise the    string "Buffer
  39.       too small" is    returned. If bbbbuuuuffff is NULL, a buffer of 128
  40.       bytes    is allocated using _O_P_E_N_S_S_L__m_a_l_l_o_c(). If    the allocation
  41.       fails, the string "OPENSSL_malloc Error" is returned.
  42.  
  43.      NNNNOOOOTTTTEEEESSSS
  44.       The number of    bits processed can be different    from the
  45.       secret bits. An export cipher    like e.g. EXP-RC4-MD5 has only
  46.       40 secret bits. The algorithm    does use the full 128 bits
  47.       (which would be returned for aaaallllgggg____bbbbiiiittttssss), of which however
  48.       88bits are fixed. The    search space is    hence only 40 bits.
  49.  
  50.      BBBBUUUUGGGGSSSS
  51.       If _S_S_L__C_I_P_H_E_R__d_e_s_c_r_i_p_t_i_o_n() is called    with cccciiiipppphhhheeeerrrr being
  52.       NULL,    the library crashes.
  53.  
  54.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  55.       See DESCRIPTION
  56.  
  57.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  58.       ssl(3), SSL_get_current_cipher(3), SSL_get_ciphers(3)
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/10/00)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSSSSSLLLL____CCCCIIIIPPPPHHHHEEEERRRR____ggggeeeetttt____nnnnaaaammmmeeee((((3333)))) 11118888////SSSSeeeepppp////2222000000000000    ((((0000....9999....6666))))    SSSSSSSSLLLL____CCCCIIIIPPPPHHHHEEEERRRR____ggggeeeetttt____nnnnaaaammmmeeee((((3333))))
  71.  
  72.  
  73.  
  74.       SSL_CIPHER_description - get SSL_CIPHER properties"
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/10/00)
  130.  
  131.  
  132.  
  133.